home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / zbsize.z / zbsize
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. zzzzbbbbssssiiiizzzzeeee((((3333GGGG))))                                                          zzzzbbbbssssiiiizzzzeeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      zzzzbbbbssssiiiizzzzeeee - specifies the number of bit planes desired to comprise the Z
  10.      buffer
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      vvvvooooiiiidddd zzzzbbbbssssiiiizzzzeeee((((lllloooonnnngggg ppppllllaaaannnneeeessss))))
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _p_l_a_n_e_s   is the number of bit planes requested to be configured as Z
  17.               buffer planes. Only positive values are accepted.  The default
  18.               is machine dependent, usually 24 or 32.
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      zzzzbbbbssssiiiizzzzeeee specifies how many bit planes are requested to be configured as Z
  22.      buffer planes.  The constraints on _p_l_a_n_e_s are machine dependent.  Call
  23.      ggggeeeettttggggddddeeeesssscccc((((GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____ZZZZBBBBUUUUFFFFFFFFEEEERRRR)))) to determine the maximum number of bit
  24.      planes available for Z buffer operation.
  25.  
  26.      zzzzbbbbssssiiiizzzzeeee takes effect only after ggggccccoooonnnnffffiiiigggg has been called.  The number of
  27.      bit planes granted for the Z buffer may not be exactly what was
  28.      requested.  Call ggggeeeettttggggccccoooonnnnffffiiiigggg((((GGGGCCCC____BBBBIIIITTTTSSSS____ZZZZBBBBUUUUFFFFFFFFEEEERRRR)))) to determine how many bit
  29.      planes were configured as Z buffer planes.
  30.  
  31.      Since Z buffer bit planes are available only in the normal framebuffer,
  32.      zzzzbbbbssssiiiizzzzeeee should be called only while draw mode is NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.
  33.  
  34. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  35.      gconfig, getgconfig, getgdesc, mssize
  36.  
  37. NNNNOOOOTTTTEEEESSSS
  38.      This routine is available only in immediate mode.
  39.  
  40.      Since most machines support only a finite set of Z buffer sizes, _p_l_a_n_e_s
  41.      is rounded to the nearest supported size.
  42.  
  43.      IRIS-4D G, GT, GTX, VGX, and VGXT models, the Personal Iris, Iris Indy,
  44.      Indigo Entry, XL, XS, XS24, XZ, Elan and Extreme systems do not support
  45.      zzzzbbbbssssiiiizzzzeeee.
  46.  
  47.      The IRIS-4D RealityEngine models support only values of 0, 24 or 32
  48.      _p_l_a_n_e_s.  On these models the Z buffer and the depth component in the
  49.      multisample buffer are independent.  When the multisample buffer is
  50.      requested in the current framebuffer configuration, it is recommended to
  51.      call zzzzbbbbssssiiiizzzzeeee((((0000)))), as no Z buffer planes are required.
  52.  
  53. BBBBUUUUGGGGSSSS
  54.      On the IRIS-4D RealityEngine models the framebuffer cannot be configured
  55.      to consist of 32 Z buffer planes (or 32 depth planes in the multisample
  56.      buffer) and 8 color planes for each of the RGB color buffers
  57.      simultaneously.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.